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THE DATA RECONFIGURATION SERVICE -- 


COMPILER/INTERPRETER IMPLEMENTATION NOTES 


I. NEW FEATURES OF THE LANGUAGE 


Ls The meaning of S(#,E,,1) is only find an arbitrary 
number (<=256) of EBCDIC characters and store them in 
identifier S. This descriptor is terminated only by 
an invalid EBCDIC or by exceeding maximum permissible 
character count (256). 

25 The assignment (S .<=. Т) causes all attributes of 
identifier T to be given to S, i.e., length, type, 
and contents. 

3. (S .<=. T || X) concatenates X onto the right-hand 
side of Т and stores the result in S. If T and X 
are binary the resulting value has a length equal 
to the sum L(T) + L(X). 


4. T(X) joins L(X) and V(X) as a built-in identifier 
function. 
T(X) = type of identifier X. 
L(X) = length of contents of X. 
V(X) = contents of X converted to binary 
(decimal - binary is presently the only 
transformation). 
Die New types ED and AD are EBCDIC and ASCII encoded 


decimal, respectively. These have been added to 
complement the V(X) function. 


6. New type SB has been added as signed binary. Type B 
is a logical binary string. 
ДА The syntactic notation for return-from-a-form has 


been changed. See new syntax. 
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II. NEW SYNTAX 


form 

rule 

label 
inputstream 
terms 
outputstream 
term 


identifier 
descriptor 


comparator 


replicationexpr 
datatype 
valueexpr 
lengthexpr 
connective 
concatexpr 
value 
arithmeticexpr 
primary 


operator 
literal 


literaltype 
string 
control 
options 


SFUR 


rule | form 

label inputstream outputstream; 

INTEGER | NULL 

terms | NULL 

term terms, term 

:terms | NULL 

identifier identifier descriptor | 

descriptor comparator 

<alpha followed by 0-3 alphanumerics> 

(replicationexpr, datatype, valueexpr, 

lengthexpr control) 

(concatexpr connective concatexpr control) | 

(identifier .<=. concatexpr control) 

# | arithmetricexpr | NULL 

B 

concatexpr NULL 

arithmeticexpr | NULL 

She | „ьт. | etn | GE (| .Ё0. [| 2МЕ, 

value | concatexpr value 

literal arithmeticexpr 

primary arithmeticexpr operator primary 

identifier | L(identifier) | V(identifier) | 
INTEGER 

see Meee ace | 

literaltype "string" 


B|o|x [|Е | А | Ер | AD | s 
<from 0 to 256 chars> 
:options | NULL 

SFUR (arithmeticexpr) 
SFUR (arithmeticexpr) 
s | F |U | SR | FR | UR 


| SFUR (arithmeticexpr), 


[Page 2] 


RFC 194 


o |x | КЕ | А | Ер | ad | sB | T (identifier) 
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III. THE FORM INTERPRETER 
Interpreter Overview 


The interpreter is a simple minded machine having the virtue of 
helping the compiler writer by providing a rather powerful instruction 


set for hard-to-compile operations. Figure 1 shows the machine 
configuration: 
зе ырл ЕЕ + жесе шәшш + 
| inputstream | | outputstream 
з= еы еы тыы + кка лк ард ыыы аы + 
/\ / 
\ / 
\ / 
\ \/ 
тезеле ешт ЕЕ + 
| CPU | 
Ж========шш-с ш > шшш + 
d 
\/ | 
езешшн ны a + 
Storage: | Instruction | 
| Sequence | 
к=к ышш = зыш ема шышы Ышш + 
| Label Table | 
+---------------------—-—- + 
| Literal/Identifier | 
| Pool | 
t--- 55-55-55 ---------- + 


Variable length 
string area 


Fig. 1. Form Interpreter 
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The CPU is a box full of miscellaneous parts, the most important 
being the Arithmetic Logic Unit and the instruction decoding unit. The 
CPU also maintains a collection of state registers to keep track of what 
it is doing. Figure 2 shows the rough layout. 


t--- 55-55-55 + 4+--------------- + 
| Instruction | | Instruction | 
| Counter | | Register | 
т=з 5-5-5 === + t--------------- + 
| 
| 
у 
Кыш еыш шыш шыш + 
| Operation Code | 
| Decoding | 
Run Time Stack Hoes etapa ee + 
eee ee ee ee + / | \ 
| Operands | / | \ 
he SS ышын зш ш аныш F \/ у \/ 
| | +----------------- + 
тасы ырш кыс ерене as + / Instruction \ 
| | | Interpreter | 
a a ышы ыа + | Routines | 
| | \ / 
4------------------ + +егегеешшшшз=&=шы + 
| | | /\ 
4------------------ + 
| | | 
+------------------ + у | 
| | +-------------—-- + 
ote Spe ee ee + SSS зз ыш ые | Arithmetic | 
| | ------------- > | Logic Unit | 
че ыыы T + +-------------—-- + 
| | 
4+------------------ + 
| | 
+------------------ + 
FE R + AA ET EE ETTE + 
Initial Input Ptr. | Output pointer 
4------------------ + 4+------------------ + 
4------------------ + +------------------ + 
Current Input Ptr. True/False Flag | 
анны ты ашк + ена ышат + 
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Fig. 2. The Central Processor 


The CPU is a stack machine driven by a Polish postfix instruction 
sequence. Operands placed on the Run Time Stack are used for arithmetic 
expression evaluation and for parameter passing between the interpreter 
and the built-in functions. 

The Current Input Pointer and the Output Pointer keep track of the 
two data streams. Two input pointers are needed because of the backup 
requirement in the event of rule failure. All of these pointers are bit 
pointers into the two streams. 

Various implementations of the Run Time Stack are independent of 
the interpretation of the DRS machine’s instruction set. It is 
suggested that the stack will contain instruction operands from the 
instruction stream. 

The format of a compiled instruction sequence for a form is shown 
in Fig. 3. 


16 bits 
+-------- /\--------- + 
/ \ 
$--------------------- + 
| length п in bytes | 
toe! Wipe SS SSeS + 
| | | 
| | compiled | 
| | 16-bit | 
п < instructions 
| 
| | | 
| | | 
се. $--------------------- + 


Fig. 3. Compiled Instruction Sequence Format 
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The format of the compiled Label Table is shown in Fig. 4. 


16 bits 

haa 1 тые + 

/ \ 
E а кн: + 
| length п | 
| in bytes | 
+-- гыты щы ны шош A E COE + 
| | numeric value of | byte offset | 
| | statement number | in inst. seq. | 
| +------------------ +----------------- + 
| | | 
п < | | 
| | | 
| | | 
+-- tan зыш еш уыз ыш шщ ыб шы шшр щы + 
\ / 

у 
32 bits 


Fig. 4. Compiled Label Table 
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Literals and Identifiers are compiled as shown in fig. 5. 


+—— 
/ 
+--—- 
1 1 | le 
/\ /\ | in 
4+--------- 4+---------- +--- 
/ | |////////// | 
| | Туре //////////| bi 
| ////////// | 
|  +--------- 4f---------- +--+ 
| 
| | 
\ | 
+ SS ae a ee a аннин 
/ | 
| | literals are 
| byte-aligned 
hire 
| | 
Х SHSSsenSo=sSness-esSsasee= 
Legend 
Type 0 = undefined 
1 = B (binary) 
2 = 0 (осїа1) 
3 = Х (hexadecimal) 
4 = E (EBCDIC) 
5 = A (ASCII) 
6 = ED (EBCDIC encoded 
7 = AD (ASCII encoded d 
8 


= SB (signed binary, 


Fig. 5. Compiled Li 


RFC 194 
2 2 
--/\----+  +-—---/\--—-+ 
хэ] \ 

те кынасы Torsen Sees шша шыр 

ngth n | length п | 

bytes | in bytes | 

кызыш рип t--------------+ 

| | 
t length | byte offset | 
| | 

A eae as рл кыркыш + 
| 
| Identifiers 
| 
| 

——— — — — [iiiiiiiiiiMiiiiiiiiițĖi + 
| 
| Literals 
| 
| 
| 

=-= — EE + 


decimal) 
ecimal) 
two’s complement) 


terals and Identifiers 


[Page 7] 


Data Reconfiguration Service RFC 194 


Types B, 0, X, AD, ED, and SB point to 32-bit word- aligned data 
shown below. 


+---4+---4+----- Deere eas + shit eet ae a + word-aligned, 
ES WAAAY. i ---+----- > | 32-bit right- 
+---+---+----- +-----—-- + +-----------------—-- + justified 


Types E and A point to byte-aligned symbol streams 
as shown below. 


byte-aligned, L <= 256 


4+---+---+----- 4+------- + 4+------------------------ + 
ГЕ ---+-----> | | 
+---+---+---—-- +-----—- + +----------------------—-- + 
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Instruction Format 


Since literals and identifiers will be stored in the same data 
area, more than 256 literals plus identifiers might be encountered so 
more than 8 bits are needed to reference literal/id pool. Furthermore, 
such references must be distinguished from operators in the instruction 
stream, so a 16-bit instruction will be used, as shown below. 


+-------- 4+------------------------ + 
| a | 12 | 
+-------- 4+------------------------ + 
| 
/ 
/ 
| 
V 
LD = 0 literal or identifier reference (12-bit positive integer) 
IC = 1 12-bit two’s complement integer constant 
OP = 2 operator 
AD = 3 address (12-bit positive integer) 
ARB = 4 indefinite replication factor 
NULL = 5 missing attribute of term 


The operation code decoder picks up types 0, 1, 3, 4, 
and 5 and deposits them on top of the stack (TOS). LD is an 
index into the literal/identifier table, and AD is an index 
into the instruction sequence. 


The decoder examines OP elements further: 


4 4 8 
+-------- +-------- +---------------- + 
| 0010 | |//////////////// | 
+-------- +-------- 4+---------------- + 
OP | 
+---------- > = binary operator 


0 
1 = unary operator 
2 = special operator 


[Page 9] 


Data Reconfiguration Service RFC 194 


Binary Operators (*) 


Let the TOS contain y and the next level, x. The binary operators 
compute x <bop> y, popping both x, y from stack, and put the result 
back on top of the stack. 


+---+ <-- TOS +----- + <-- TOS 
| Уу | | x-y | 
e.g x-y => +---+ ===> +—---—-- + 
| x | |/////| 
+---+ 4+----- + 


Binary Operator Encoding 


4 4 4 4 
4+-------- 4+-------- 4+-------- 4+-------- + 


| 0010 | 0000 | |////////| 


= integer + 

integer - 

integer x 

integer : (or /), no remainder 
= concatenate | | 


> о юҥ о 
Ш 


All binary operations except concatenate expect the top 
two elements on the stack to describe type В, 0, X, or SB. The 
result is always a 32-bit type B element. The concatenate 
operator fails unless both types are identical. For example: 


(*) As suggested above, the stack really contains instruction 
operands that describe data; for convenience in illustrations 
the data rather than their descriptors are shown on the stack. 
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type L value T L у 
== panene porer + керене fonan Четине + 

TOS -> | B | 32 | 4 | | B | 32 | 12 | <- TOS 
фе =ч езен == ые + ==> +------ Кары НУ poistan + 
| B | 8 | 16 | |//////|//////|//////| 
pariar t------ t------ + E ponn ешш + 
Before-operation after-operation 
peress t------ t------ + t------ иса {ф=е==нше + 

Tos -> | A | 2 | DE | | A 5 |ABCDE | <- TOS 
Toos fares Fenm + ==> +------ саша и. prenan + 
| A | 3 | Авс | |//////|//////|//////| 
t------ t------ {=н + paenan реге pasene $ 
Before || operation after || operation 


No binary operator has any effect on the TRUE/FALSE flag. 


Unary Operators 


4 4 4 4 
+--—-—-—-——— +-------- +-------- +-------- + 
| 0010 | 0001 | | | 
+-------- +-------- +-------- +-------- + 
жос | 
| | 
у | 
0 = integer minus у 
1 = load identifier 0 = evaluated contents 
(after dec - binary 
conversion) 


1 = length field 
2 = type field 


N 
ll 


Label Table Reference 
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For the unary minus operator the data described by the top of the 
stack is replaced with its 2’s complement. The form fails if the TOS 
type is not SB, В, 0, or X. 

The Load identifier expects the TOS to describe an index into the 
literal/identifier pool (that is, an LD instruction) . The TOS 
described data is replaced by 32-bit type B values. The operation fails 
if the contents cannot be converted from encoded decimal to binary. B, 
0, and X types are treated as unsigned integers, SB is treated as 2’s 
complement. 

The Label Table Reference operator expects a 32-bit type B value 
described by TOS and searches for this label in the label Table. If 
found, the TOS described data is replaced by the relative address in the 
instruction sequence of the label (in the form of an AD instruction). 

If not found, the form fails. No Unary operator has any effect on the 
TRUE/FALSE flag. 


Special Operators 


4 4 4 4 
+-------- +-------- +-------- +-------- + 
| 0010 | 0010 | | | 
+-------- +-------- +-------- +-------- + 
a a a a + / 
/ 
у / 
0 = store TOS | 
1 = return V 
2 = branch 0 = true, 1 = false, 2 = unconditional 
3 = compare О = .EQ. 2 = .LE. 4 = .GE. 
1 = .NE. 3 = .LT. 5 = .GT. 
4 = move input ptr 0 = store current into initial 
1 = store initial into current 
5 = input call 0 = no compare 
1 = compare 


6 = output call 
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Store TOS 


The TOS describes an index into the ID table and the next lower 
element in the stack describes a value to be stored. After execution, 
both elements are popped off the stack. 


Return 


The TOS describes a value to be returned to the routine which 
initiated the FORM MACHINE. The actual mechanism will be implementation 
dependent, but the FORM MACHINE will relin- quish control after this 
instruction completes execution. 


Branch 


The TOS describes an index into the instruction sequence to be used 
as the new instruction counter (IC) if the branch conditions are 
satisfied. The branch instruction checks the state of the TRUE/FALSE 
flag register and either increments the IC by 1 or replaces it with the 
TOS described element. In any case, the TOS is popped. 


Compare 


The compare operator takes the two elements described by the two 


top stack entries and compares them (.EQ.,.LT.,etc.). If n is at the 
top of the stack, and ш is just below, then m.xx.n is performed, and the 
TRUE/False flag is set accordingly. For .xx. = .EQ. or .NE. we must 


have identical type, length, and content for equality to hold. 

The other boolean comparators will not be attempted if types are 
different (i.e., form fails), but for same types, В, 0, X cause binary- 
justified compares, and A, E, AD, ED cause left-justified string 
compares with the shorter string padded with blanks. 


Move Input Pointer 
This operator (no operands) replaces the Current Input Pointer with 


the Initial Input Pointer (back-up), or the Initial Input Pointer with 
the current one (entry to rule). 


Input Call 


This is the most complex operator thus far encountered. It requires 
four operands from the run-time stack: 
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TOS +---------------------------- + 
| binary or null | length to find 
4---------------------------- + 
| LD to literal or null | value (literal) 
+---------------------------- + 
| binary code | input data type 
+---------------------------- + 
| binary, arbitrary, or null | replication count 
+---------------------------- + 


The input call operator can be invoked with the "no compare" flag 
set, in which case the value expression parameter is ignored and only 
the input type and length expressions are used. In this case, the input 
routine tries to find in the input stream as many characters of the 
required type (bits, digits, etc.) as needed to fill the length 
expression requirement. If successful, the TRUE/FALSE flag is set TRUE, 
the stack is popped to remove the input parameters, and the string 
obtained is described by the TOS. If the input stream cannot be matched 
then the parameters are popped off the stack, and the TRUE/FALSE flag is 
set FALSE. 


If the "compare" flag is set, the input stream must be searched for 
the value expression. However, we must take some care here to be sure 
we know what to look for. There are several cases: 


a) The length expression parameter is greater than the 

length of the value expression but the type of input de- 

sired is the same as the value expression type. For B, 0 

and X types, right-justify value expression in length- 

expression field, sign bit is extended left if type BS. 

If type A, E, AD, or ED pad on the right with blanks. b) Same as 
a) but length is too small. В, 0, and X type strings 

are truncated on the left. A, E, AD and ED are truncated 

on the right. c) The type of the value expression and the type 
parameter 

differ. This case is deferred for discussion and pre- 

sently is considered an error causing form failure. 


If the input string matches, then the TRUE/FALSE flag is set true, 
the parameters are popped from the stack, and the resulting string is 
described by the TOS. Otherwise, the FALSE flag is set and the 
parameters are popped. 


When a successful match is found the input subroutine always 
advances the Current Input Pointer by the appropriate amount. Since we 
are dealing at the bit level this pointer must be maintained as a bit 
pointer! 
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Output Call 


This routine utilizes the same parameters as the input call, but 
operates on the output stream. The TRUE/FALSE flag is not distributed 
by this operator. As for input, there are four parameters on top of the 
stack, the length expression value, the value expression value, the 
desired output type, and the replication expression value. When there 
is a mis- match between the output type and the value expression type, a 
conversion must take place. The value expression is trans- formed into 
the desired output type and fitted into the field length specified by 
the length expression. 


Truncation and Padding Rules 


a) Character -> character (A,E,AD,ED -> A,E,AD,ED) conversion 

is left-justified and truncated or padded with blanks 

on the right. b) Character -> numeric and numeric -> character 
conversion is 

right-justified and truncated or padded on the left with 

zeros. Beware! Two’s complement numbers may be bollixed 

by this. с) Numeric -> character conversion is right-justified and 

left padded with blanks or left-truncated. As for the unary 
operators, a numeric bit-string is treated as unsigned, except SB which 


is treated as two’s complement. Thus we have: 
(1,ED,X"FF",3) = Е”255”/ 
(1,ED,X"100",3) = E’256’ 
but (1,ED,SB"10000000",4) = E’-256’ 


If the output routine is able to perform the desired action, it 
advances the Output Stream Pointer, and pops all parameters from the 
run-time stack. 
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V. INSTRUCTION SET 


it/id ref 
int const 


address 

null parameter 
add 

subtract 
multiply 
divide 
concatenate 
unary minus 
load id value 
load id length 
load id type 
look up label 
sto 

return 


branch true 
branch false 
branch 

compare equal 
compare not equal 
compare <= 

call output 

call input 


current -> initial 


initial -> current 


LD <num> 


IC <num> 


AD <num> 
NULL 
ADD 
SUB 
MUL 
DIV 
CON 
UNIN 
LIV 
LIL 
EFE 
LVL 
STO 
RET 


BT 


BF 


BU 


CEQ 


CNE 

CLE 

OUT 

IN ( INC 
INN 


compare 


SCIP 


SICP 


no compare 
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Literal or identifier 
reference -> TOS 

small 2’s comp. integer 
constant -> TOS 

Address -> TOS 

missing term attribute 


TOS = x,y x + y -> TOS 

TOS = х,у x - у -> TOS 

TOS = x,y x * y -> TOS 

TOS = x,y x/y -> TOS 

TOS = x,y x| |y -> TOS 

TOS = x -x -> TOS 

TOS = ID x V(LD x) -> TOS 

TOS = ID x V(LD x) -> TOS 

TOS = ID x V(LD x) -> TOS 

TOS = x AD x -> TOS 

TOS = x,y yu>x 

TOS = x return to 

caller with x 

TOS = AD x AD x -> Instr. 
counter 

TOS = AD x AD x -> Instr. 
counter 

TOS = AD x AD x -> Instr. 
counter 

TOS = x,y (y.EQ.x) -> 
TRUE/FALSE 
flag 

TOS = x,y (y.NE.x) -> T/FF 

TOS = x,y (y.LE.x) -> T/FF 

TOS = r,t,v,l (r,t,v,1) -> output 

TOS = r,t,v,l (xr,t,v,1) -> TOS 

CIP =>. TTP (store current input 

ptr - initial IP) 
IIP -> CIP (store initial input 


ptr - CIP) 
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VI. EXAMPLE COMPILATION 


FORM SOURCE GENERATED POLISH INSTRUCTION SEQUENCE 
ADDR. INSTR. COMMENTS 
(NUMB.<=.1); 0 SICP RULE PRELUDE 
1 ie Ж 
2 LD 0 REFERENCE TO NUMB 
3 STO STORE IN NUMB 
4 SCIP RULE POSTLUDE 
1 CC(,E,,1:FR(99)), 5 SICP RULE PRELUDE 
6 NULL NO REPLICATION EXPRESSION 
7 IC 4 TYPE EBCDIC 
8 NULL NO VALUE EXPRESSION 
9 IC 1 LENGTH 
10 INN INPUT CALL WITH NO COMPARE 
Тї АР 15 
12 BT SKIP RETURN IF INN SUCCEEDS 
13 IC 99 RETURN CODE 
14 RET RETURN TO CALLER IF FAILED 
15 LD 1 REFERENCE TO CC 
16 STO STORE INPUT DATA IN CC 
LINE(,E,,121: 17 NULL NO REPLICATION EXPRESSION 
FR(99)), 18 IC 4 TYPE IS EBCDIC 
19 NULL NO VALUE EXPRESSION 
20 IC 121 LENGTH 
21 INN INPUT WITH NO COMPARE 
22 AD 26 
23 BT SKIP RETURN IF OK 
24 IC 98 RETURN CODE 
25 RET RETURN TO CALLER IF FAILED 
26 LD 2 REFERENCE TO LINE 
27 STO STORE INPUT IN LINE 
:CC, 28 SCIP SUCCESSFUL INPUT 
29 NULL NO REPLICATION FACTOR 
30 LD 1 REFERENCE TO CC 
31 LIT TYPE OF CC 
32 LD 1 REFERENCE TO VALUE OF CC 
33 LD 1 CC AGAIN 
34 LIL LENGTH OF CC 
35 OUT OUTPUT CC 
(,ED, NUMB, 2), 36 NULL NO REPLICATION 
37 IC 6 TYPE IS ED 
38 LD 0 REFERENCE TO VALUE OF NUMB 
39 IC 2 LENGTH OF OUTPUT FIELD 
40 OUT OUTPUT NUMB AS EBCDIC DEC. 
GE,E".",1), 41 NULL NO REPLICATION 
42 IC 4 ТҮРЕ IS EBCDIC 
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43 LD 3 REFERENCE TO E"." 
44 IC 1 LENGTH TO OUTPUT 
45 OUT OUTPUT THE PERIOD 
(,E, LINE,117), 46 NULL NO REPLICATION 
47 IC 4 ТҮРЕ IS EBCDIC 
48 LD 2 REFERENCE TO LINE 
49 IC 117 LENGTH TO OUTPUT 
50 OUT PUT OUT CONTENTS OF LINE 
(NUMB.<=.NUMB+1: 51 LD 0 REFERENCE TO NUMB 
U(1)); 52 IC 1 AMOUNT TO ADD 
53 ADD ADD TO NUMB 
54 LD 0 REFERENCE TO NUMB 
55 STO STORE BACK INTO NUMB 
56 AD 5 PLACE TO GO 
57 B UNCONDITIONAL BRANCH BACK 


LITERAL/IDENTIFIER TABLE 


0 NUMB 
1 CC 

2 LINE 
3 EFT 


LABEL TABLE 


LABEL OFFSET 
1 5 
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[ This RFC was put into machine readable form for entry ] 


[ into the online RFC archives by Simone Demmel 6/97 ] 
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